home *** CD-ROM | disk | FTP | other *** search
/ MacUser Mac Bin 28 / MACUSER-MACBIN28A-1996-03.ISO.7z / MACUSER-MACBIN28A-1996-03.ISO / Demo / MachTen 4.0.2 Demo / X Window Software / X11R5 / man / mann / fs.0 < prev    next >
Text File  |  1995-06-30  |  6KB  |  259 lines
  1. NAME
  2.        fs - X font server
  3.  
  4. SYNOPSIS
  5.        fs [-config configuration_file] [-port tcp_port]
  6.  
  7. DESCRIPTION
  8.        Fs  is the X Window System font server.  It supplies fonts
  9.        to X Window System display servers.
  10.  
  11. STARTING THE SERVER
  12.        The server is usually run by a system  administrator,  and
  13.        started via boot files like /etc/rc.local.  Users may also
  14.        wish to start private font servers for  specific  sets  of
  15.        fonts.
  16.  
  17. OPTIONS
  18.        -config configuration_file
  19.                Specifies  the  configuration file the font server
  20.                will use.
  21.  
  22.        -ls listen-socket
  23.                Specifies a file descriptor which is  already  set
  24.                up  to  be used as the listen socket.  This option
  25.                is only intended to be used  by  the  font  server
  26.                itself when automatically spawning another copy of
  27.                itself to handle additional connections.
  28.  
  29.        -port tcp_port
  30.                Specifies the TCP port number on which the  server
  31.                will listen for connections.
  32.  
  33. SIGNALS
  34.        SIGTERM This causes the font server to exit cleanly.
  35.  
  36.        SIGUSR1 This signal is used to cause the server to re-read
  37.                its configuration file.
  38.  
  39.        SIGUSR2 This signal is used to cause the server  to  flush
  40.                any cached data it may have.
  41.  
  42.        SIGHUP  This  signal is used to cause the server to reset,
  43.                closing all active connections and re-reading  the
  44.                configuration file.
  45.  
  46. CONFIGURATION
  47.        The  configuration language is a list of keyword and value
  48.        pairs.  Each keyword is followed by an '='  and  then  the
  49.        desired value.
  50.  
  51.        Recognized keywords include:
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58. X Version 11                Release 5                           1
  59.  
  60.  
  61.  
  62.  
  63.  
  64. FS(1)                                                       FS(1)
  65.  
  66.  
  67.        catalogue (list of string)
  68.               Ordered  list  of  font path element names.  Use of
  69.               the keyword "catalogue" is very misleading at  pre-
  70.               sent,  the  current  implementation only supports a
  71.               single catalogue ("all"),  containing  all  of  the
  72.               specified fonts.
  73.  
  74.        alternate-servers (list of string)
  75.               List of alternate servers for this font server.
  76.  
  77.        client-limit (cardinal)
  78.               Number  of  clients  this  font server will support
  79.               before refusing service.  This is useful for tuning
  80.               the load on each individual font server.
  81.  
  82.        clone-self (boolean)
  83.               Whether  this  font  server should attempt to clone
  84.               itself when it reachs the client-limit.
  85.  
  86.        default-point-size (cardinal)
  87.               The default pointsize  (in  decipoints)  for  fonts
  88.               that don't specify.
  89.  
  90.        default-resolutions (list of resolutions)
  91.               Resolutions  the  server supports by default.  This
  92.               information  may  be  used  as  a  hint  for   pre-
  93.               rendering,  and  substituted for scaled fonts which
  94.               do not specify a resolution.
  95.  
  96.        error-file (string)
  97.               Filename of  the  error  file.   All  warnings  and
  98.               errors will be logged here.
  99.  
  100.        port (cardinal)
  101.               TCP  port  on which the server will listen for con-
  102.               nections.
  103.  
  104.        use-syslog (boolean)
  105.               Whether syslog(3) (on supported systems) is  to  be
  106.               used for errors.
  107.  
  108. EXAMPLE
  109.        #
  110.        # sample font server configuration file
  111.        #
  112.  
  113.        # allow a max of 10 clients to connect to this font server
  114.        client-limit = 10
  115.  
  116.        # when a font server reaches its limit, start up a new one
  117.        clone-self = on
  118.  
  119.        # alternate font servers for clients to use
  120.        alternate-servers = hansen:7001,hansen:7002
  121.  
  122.  
  123.  
  124. X Version 11                Release 5                           2
  125.  
  126.  
  127.  
  128.  
  129.  
  130. FS(1)                                                       FS(1)
  131.  
  132.  
  133.        # where to look for fonts
  134.        # the first is a set of Speedo outlines, the second is a set of
  135.        # misc bitmaps and the last is a set of 100dpi bitmaps
  136.        #
  137.        catalogue = /usr/lib/fonts/speedo,
  138.             /usr/lib/X11/ncd/fonts/misc,
  139.             /usr/lib/X11/ncd/fonts/100dpi/
  140.  
  141.        # in 12 points, decipoints
  142.        default-point-size = 120
  143.  
  144.        # 100 x 100 and 75 x 75
  145.        default-resolutions = 100,100,75,75
  146.  
  147.  
  148. FONT SERVER NAMES
  149.        One  of  the  following  forms  can be used to name a font
  150.        server that accepts TCP connections:
  151.  
  152.            tcp/hostname:port
  153.            tcp/hostname:port/cataloguelist
  154.  
  155.        The  hostname  specifies  the  name  (or  decimal  numeric
  156.        address)  of  the machine on which the font server is run-
  157.        ning.  The port is the decimal TCP port on which the  font
  158.        server  is  listening  for connections.  The cataloguelist
  159.        specifies a list of catalogue names, with '+' as a separa-
  160.        tor.
  161.  
  162.        Examples:                       tcp/expo.lcs.mit.edu:7000,
  163.        tcp/18.30.0.212:7001/all.
  164.  
  165.        One of the following forms can be  used  to  name  a  font
  166.        server that accepts DECnet connections:
  167.  
  168.            decnet/nodename::font$objname
  169.            decnet/nodename::font$objname/cataloguelist
  170.  
  171.        The  nodename  specifies  the  name  (or  decimal  numeric
  172.        address) of the machine on which the font server  is  run-
  173.        ning.   The  objname  is a normal, case-insensitive DECnet
  174.        object name.  The cataloguelist specifies a list of  cata-
  175.        logue names, with '+' as a separator.
  176.  
  177.        Examples:         DECnet/SRVNOD::FONT$DEFAULT,        dec-
  178.        net/44.70::font$special/symbols.
  179.  
  180. SEE ALSO
  181.        X(1), Font server implementation overview
  182.  
  183. BUGS
  184.        Multiple catalogues should be supported.
  185.  
  186.  
  187.  
  188.  
  189.  
  190. X Version 11                Release 5                           3
  191.  
  192.  
  193.  
  194.  
  195.  
  196. FS(1)                                                       FS(1)
  197.  
  198.  
  199. COPYRIGHT
  200.        Copyright 1991, Network Computing Devices,  Inc  Copyright
  201.        1991, Massachusetts Institute of Technology
  202.        See X(1) for a full statement of rights and permissions.
  203.  
  204. AUTHORS
  205.        Dave Lemke, Network Computing Devices, Inc
  206.        Keith Packard, Massachusetts Institute of Technology
  207.  
  208.  
  209.  
  210.  
  211.  
  212.  
  213.  
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256. X Version 11                Release 5                           4
  257.  
  258.  
  259.